home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / bbs / sfame120.zip / SFAME.DOC < prev    next >
Text File  |  1996-05-10  |  81KB  |  1,524 lines

  1.  
  2.                   ╔════════════════════════════════════════╗
  3.                   ║                                        ║
  4.                   ║         ╓─┐ ╥──┐ ╓──┐ ╓─╥─┐ ╥──┐       ║
  5.                   ║         ╙─┐ ╟─   ╟──┤ ║ ║ │ ╟─         ║
  6.                   ║        ╙──┘ ╨    ╨  ┴ ╨ ╨ ┴ ╨──┘       ║
  7.                   ║                   v1.2                 ║
  8.                   ║     SPITFIRE ADVANCED MESSAGE EDITOR   ║
  9.                   ║                                        ║
  10.                   ║       Copyright By Richard Lemaster    ║
  11.                   ║             Over The Line BBS          ║
  12.                   ║              (918) 250-0542            ║
  13.                   ║                                        ║
  14.                   ╚════════════════════════════════════════╝
  15.  
  16.  
  17.   INTRODUCTION
  18.   ────────────
  19.  
  20.   SFAME is a utility written to greatly enhance the default SPITFIRE
  21.   Message Menu.  The SPITFIRE Advanced Message Editor interfaces closely
  22.   with SPITFIRE's message base but also provides the BBS caller with many
  23.   options not directly available in SPITFIRE.  Some of SFAME's advanced
  24.   features include a full-screen message editor, grouping of message
  25.   conferences, caller configuration options, message scripts, file attaches
  26.   to messages and full alias support.
  27.  
  28.  
  29.   QUICK SETUP
  30.   ───────────
  31.  
  32.   Create a directory for SFAME and unzip the SFAME archive in this
  33.   directory. Next, type CONFIG to setup the default SFAME files. You
  34.   will be asked if you want to create a SFAME.CFG file. Choose Y to
  35.   continue. You will then be asked if you want to create a GROUPS.DAT
  36.   file. Choose Y to continue. SFAME is now setup and ready to use. To
  37.   exit CONFIG, choose Q from the main menu. You can then type SFAME
  38.   from the command line.
  39.  
  40.  
  41.   CONFIGURATION
  42.   ─────────────
  43.  
  44.   Begin by creating a directory which will be used by SFAME. For the
  45.   purpose of explanation, our examples, will refer to a directory named
  46.   SFAME located on the C: drive.
  47.  
  48.   Next, unzip the SFAME archive file into the C:\SFAME directory.
  49.   This will place the files included in the distribution package into this
  50.   directory.  To simplify the configuration process, SFAME includes a file,
  51.   CONFIG.EXE that can be used to define SFAME's operational values.
  52.   Simply type CONFIG from the DOS prompt while in the SFAME directory. You
  53.   will then be asked if you would like to create a SFAME.CFG file. Choose
  54.   Yes to continue. You will then be asked if you would like to create the
  55.   GROUPS.DAT file. Choose Yes to continue. You will then see the main
  56.   config menu. SFAME is now ready to use. From the Main Menu Choose
  57.   option 1 to edit the default SFAME settings for your BBS. The next
  58.   screen will display the settings you can change by selecting the
  59.   letter for an option. The options available are:
  60.  
  61.   <A> Script Directory - This is the directory where your scripts are
  62.                          placed. Scripts should be placed in a separate
  63.                          directory to keep the SFAME home directory clean.
  64.                          Scripts will be be explained later.
  65.  
  66.   <B> Use Scripts      - Set this to TRUE if you would like scripts
  67.                          available in the message editor. Scripts will
  68.                          be explained later. You might want to read more
  69.                          about scripts before setting this option.
  70.  
  71.   <C> Main Menu Logoff - Setting this to TRUE will allow callers to
  72.                          log-off from the SFAME main menu. It will
  73.                          display a Goodbye.bbs/clr screen if found in
  74.                          your SPITFIRE display directory.
  75.  
  76.   <D> Main Menu Extension Name - This is the name displayed on the SFAME
  77.                          main menu for the main menu extension. When the
  78.                          extension option is choosen, SFAME will first
  79.                          check for a NODE#.BAT file to execute. The #
  80.                          is the node number. NODE2.BAT will be run if
  81.                          the caller is logged on node 2. If a NODE#.BAT
  82.                          file is not found, SFAME will then check for a
  83.                          NODE.BAT file. If a NODE.BAT file is not found,
  84.                          the caller will be returned to the SFAME main
  85.                          menu. You can use NODE0.BAT for local mode. The
  86.                          NODE#.BAT or NODE.BAT can be used to run a mail
  87.                          door such as LAKOTA or any other door or menu
  88.                          extension program. When SFAME runs the NODE#.BAT
  89.                          or NODE.BAT file, it will create the same type
  90.                          of drop file used on the SFAME command line in
  91.                          the SFAME home directory. If run locally, it
  92.                          will create a SFMESS.DAT file. Leave the
  93.                          Main Menu Extension Name blank to disable.
  94.  
  95.   <E> Use Printer      - If this is set to TRUE, all log information
  96.                          will also be sent to the printer. You must
  97.                          also have SPITFIRE set to use the printer for
  98.                          this to work. You can then set this to TRUE
  99.                          and control whether the printer is used by
  100.                          changing the setting in SPITFIRE.
  101.  
  102.   <F> Inactive Timeout - This is the number of seconds of inactivity
  103.                          before the caller is returned to SPITFIRE.
  104.  
  105.   <G> Swap Memory During Shell - If this is set to TRUE then SFAME will
  106.                          remove itself from memory when the main menu
  107.                          extension is choosen, before a message upload
  108.                          or a file download.
  109.  
  110.   <H> Swap Drive/Directory - You can specify where the swap file should
  111.                          be placed. This should be a RAM drive for faster
  112.                          memory swapping. If blank, the swap file will be
  113.                          placed in the SFAME home directory.
  114.  
  115.   <I> Log File Name    - This is the file name where callers activity is
  116.                          written. You can enter CALLERS.TMP here if you
  117.                          want to use SPITFIRE's CALLERS.LOG file. If left
  118.                          blank, SFAME.LOG will be used.
  119.  
  120.   <J> Force Comments To Conference #1 - If you set this to TRUE then
  121.                          all messages to the sysop will be placed in
  122.                          group #1, conference #1.
  123.  
  124.   <K> Group Shared With SpitFire - This is the message group which shares
  125.                          its message base directory with SPITFIRE. Message
  126.                          groups will be explained later. You can set this
  127.                          to 1 for now.
  128.  
  129.   <L> File Attach Directory - This is the directory where files attached
  130.                          to messages are uploaded and stored. File
  131.                          attaches should be stored in a separate directory
  132.                          to help keep the SFAME home directory clean.
  133.  
  134.   <M> Min UL Space     - This is the minimum free disk space in KB's that
  135.                          must be available to allow a file attach upload.
  136.                          If you set this to 1000, then there must be at
  137.                          least 1MB of free disk space.
  138.  
  139.   <N> Days To Keep File Attaches - This is the number of days files that
  140.                          that are attached to messages are kept before
  141.                          deleting. If a file is older than this setting,
  142.                          it will be deleted even if the message is still
  143.                          active. This setting should be close to the
  144.                          SPITFIRE old message purge date.
  145.  
  146.   <O> Internet Address - This is your Internet domain name such as
  147.                          bbsname.com if you have one. If you don't have
  148.                          a domain name, just leave this blank. This is
  149.                          used in scripts to make the users Internet
  150.                          address for your BBS. Scripts and the users
  151.                          Internet address are explained below.
  152.  
  153.   <P> Allow Address Books - With this turned On, users will be able
  154.                          to store up to 20 addresses in their book. The
  155.                          book for each caller takes up 768 bytes. If you
  156.                          have alot of users, that could add up to alot of
  157.                          disk space.
  158.  
  159.   <R> Spell Check Security - This is the minimum security needed to use
  160.                          the spell checker. When editing a message, you
  161.                          can select <Ctrl-X> then <30> to use the spell
  162.                          checker. When you select this option, SFAME will
  163.                          first save your message to a text file. It will
  164.                          then shell to the file SPELL.BAT if it exists.
  165.                          SFAME will pass the message text file as %1.
  166.                          The SPELL.BAT file should contain the commands
  167.                          to execute your spell checker. I've included
  168.                          a sample SPELL.BAT file which uses a spell
  169.                          checker called ShareSpell. This is a good text
  170.                          based program which works well with DOORWAY. To
  171.                          get a copy, you can freq SPELL from my BBS. The
  172.                          file name for the version I have is SS24B.ZIP but
  173.                          there might be a newer version available. Any
  174.                          text based program should be able to work with
  175.                          DOORWAY. When SFAME shells to the file SPELL.BAT,
  176.                          it will create a file called DOOR.SYS which is
  177.                          used by DOORWAY. When you return to SFAME, the
  178.                          new copy of the message will be imported back
  179.                          into the SFAME editor. You can also have node
  180.                          specific SPELL#.BAT files where # is the node
  181.                          number. You should probably make a SPELL0.BAT
  182.                          for local use which doesn't contain the DOORWAY
  183.                          commands. The SPELL0.BAT can run any program
  184.                          you like. It doesn't have to be text based like
  185.                          the one used with DOORWAY.
  186.  
  187.   <S> Check for Doorway Mode - If you want SFAME to make sure the caller
  188.                          has Doorway mode before running the spell checker,
  189.                          set this to Yes. If SFAME does not detect Doorway
  190.                          mode, SFAME will not exit to the spell checker.
  191.                          If a caller tries to use the spell checker without
  192.                          Doorway mode, they probably won't be able to use
  193.                          the spell checker's commands and have to drop
  194.                          carrier to exit. If your spell checker uses
  195.                          arrow or function keys, set this to Yes.
  196.  
  197.   <T> Force Message Scan - If you want SFAME to scan for messages the first
  198.                          time the user calls each day, set this to Yes. If
  199.                          set to No, the user will be asked if they want to
  200.                          scan for new messages. This option in only used if
  201.                          you use the SCAN command line parameter.
  202.  
  203.   <Y> Make New Phonbook.Dat File - The PHONBOOK.DAT file is used to
  204.                          store the users address books. This option will
  205.                          erase the current file and create a new one. When
  206.                          you create a new file, all the address books
  207.                          from the old file will be erased.
  208.  
  209.   <Z> Make New Alias.Ptr File - The ALIAS.PTR file is used to search for
  210.                          an alias when entering a message or when choosing
  211.                          a new alias. If you erase the CALLERS.DAT file
  212.                          you will need to make a new ALIAS.PTR file.
  213.  
  214.   <Q> Quit             - Returns to the main menu.
  215.  
  216.   You can also choose F1 for help with an option while using CONFIG.
  217.  
  218.   You should next select option 2 from the main menu, Edit Message Groups.
  219.   Before setting up the message groups, I'll explain what a group is. A
  220.   group is simply a message base in its own directory consisting of the
  221.   regular SPITFIRE message data files. SPITFIRE supports 1 message base.
  222.   By using groups, you can have up to 250 message bases (groups). Each
  223.   group can consist of 784 conferences as in SPITFIRE. To use groups with
  224.   echomail, you must also use AMAIL with tags to toss the mail packets
  225.   into different directories. In your AMAIL.CFG file you should use the
  226.   SFMSGDIR option to define the directories for each group. The word
  227.   following the "=" is the TAG name for the group.
  228.   Example:
  229.  
  230.     SFMSGDIR C:\SF\MESSAGE1=GROUP1
  231.     SFMSGDIR C:\SF\MESSAGE2=GROUP2
  232.     SFMSGDIR C:\SF\MESSAGE3=GROUP3
  233.  
  234.   In your AREAS.BBS file you should have:
  235.  
  236.     !1@GROUP1 SPITFIRE
  237.     !1@GROUP2 BBS
  238.     !1@GROUP3 FREEMAIL
  239.     !2@GROUP1 CDROM
  240.  
  241.   The word following the "@" in the above lines is the TAG name for the
  242.   conference. By using the above examples, if AMAIL finds a message for
  243.   the conference SPITFIRE, it will be placed in conference 1 in the directory
  244.   C:\SF\MESSAGE1 because that is the directory specified for the tag GROUP1
  245.   in the AMAIL.CFG file. If AMAIL finds a message for the conference FREEMAIL,
  246.   it will be placed in conference 1 in the directory C:\SF\MESSAGE3. If
  247.   AMAIL finds a message for the conference CDROM, it will be placed in
  248.   conference 2 in the directory C:\SF\MESSAGE1. Your AREAS.BBS should
  249.   contain a line for each conference in each group. Read the AMAIL docs
  250.   for more information on tags and multi-base SPITFIRE setup.
  251.  
  252.   By using groups, you can place all FIDONET, SFNET or other networks
  253.   in their own group instead of having them all mixed together. You might
  254.   have to start using CONFIG and SFAME before you fully understand what
  255.   groups are. For now, just think of a group as a message base and setting
  256.   up each group is like setting up a SPITFIRE message base. When you choose
  257.   option 2, you will be asked if you would like to create the GROUPS.DAT
  258.   file. Choose YES and continue to the next menu. The screen now displays
  259.   the defaults for group 1 and a menu to change the settings. Even if you
  260.   only plan to use 1 group, you should still configure it. The options are:
  261.  
  262.   <1> Description      - This will let you change the name of the group.
  263.                          The maximum length is 40 characters.
  264.  
  265.   <2> SfMConf.dat File Name - Each group has its own SFMCONF.DAT type
  266.                          file. This should be the name of the SFMCONF.DAT
  267.                          type file for this group. You can later choose
  268.                          option 3 from the main menu to edit the message
  269.                          conferences in this file. This can also be the
  270.                          same SFMCONF.DAT file used by SPITFIRE.
  271.  
  272.   <3> Message Directory - This is the directory where the SFMSG[#].PTR,
  273.                          SFMSG[#].DAT, SFMSG[#].LMR, and SFMSG[#].IDX
  274.                          files are stored. This can be set to the same
  275.                          message directory used by SPITFIRE.
  276.  
  277.   <4> Group Security   - This is the security level needed to access this
  278.                          group.
  279.  
  280.   <5> Group Access     - Set this to E and only callers with the Group
  281.                          Security level have access. Choose G and callers
  282.                          with a security level equal to or greater than
  283.                          the Group Security have access.
  284.  
  285.   <6> Aliases          - Set this to TRUE if callers are allowed to use
  286.                          an alias in this group.
  287.  
  288.   <7> File Attaches    - Set this to TRUE if callers are allowed to
  289.                          attach files to messages in this group.
  290.  
  291.   <A> Add New Group    - Adds a new group. You can have up to 250 groups.
  292.  
  293.   <I> Insert Group     - This will insert a new group in front of the
  294.                          current one.
  295.  
  296.   <D> Delete Group     - Deletes a group. If you only have 1 group, you
  297.                          can't delete it.
  298.  
  299.   <U> Update LMR Files - If you change the maximum callers allowed on
  300.                          your BBS, choose this to rebuild the SFMSG[#].LMR
  301.                          files to the new correct size.
  302.  
  303.   <Q> Quit             - This will return you to the CONFIG main menu.
  304.  
  305.   You can also choose F1 for help with an option while using CONFIG.
  306.  
  307.   The next option on the main menu, 3 - Edit Message Conferences, will
  308.   allow you to edit the message conferences for any group. You should
  309.   choose this to setup the conferences when you start a new group. The
  310.   options for editing the message conferences are the same as used in
  311.   SPITFIRE. Refer to your SPITFIRE manual for help with a command.
  312.  
  313.   The next option on the main menu is Edit Scripts. Before explaining how
  314.   to setup the scripts, I should first explain the language and use of
  315.   scripts. Below are the script commands allowed:
  316.  
  317.   ASK - Command Line: ASK "<question>" <variable number> <max length(opt.)>
  318.         The <question> is the prompt displayed to the caller.
  319.         The <variable number> is a number 1-10 that the answer is stored in.
  320.         The <max length> is the maximum length of the answer and is optional.
  321.         Example:  ASK "What is your name: " 2 30
  322.         This would display the question, and store the answer in variable
  323.         number 2.
  324.  
  325.   DISPLAY - Command Line: DISPLAY "<text>"
  326.         This will display the <text> on the screen.
  327.  
  328.   DISPLAYANSWER - Command Line: DISPLAYANSWER "<text>" <variable number>
  329.        This display <text> followed by whatever is stored in <variable number>.
  330.  
  331.   DISPLAYFILE - Command Line: DISPLAYFILE <file name>
  332.         This will display the file <file name> if found. The <file name>
  333.         must include the dir\path if it is not in the SFAME home directory.
  334.  
  335.   GETCHOICE - Command Line: GETCHOICE "<prompt>" <choices> <variable number>
  336.         This will display <prompt> and wait for the user to enter a
  337.         character in the <choices> string. The answer will be stored in
  338.         the <variable number>.
  339.         Example: display "<C> Continue"
  340.                  display "<Q> Quit"
  341.                  GETCHOICE "Enter Selection" CQ 1
  342.         This will display the prompt and wait for the user to press
  343.         C,Q or <ENTER>. If the user pressed <ENTER> then the first
  344.         character in <choices> will be used. If they pressed enter in this
  345.         example, C will be placed in variable 1. This can be used for menus
  346.         or <Y/n> questions. You can have up to 250 choices in a menu.
  347.  
  348.   GOTO - Command Line: GOTO <label>
  349.         This is the same as the DOS batch file GOTO command. It will
  350.         search the script for <label> and continue.
  351.         Example: 
  352.           GOTO End
  353.           ...
  354.           ...
  355.           :END
  356.  
  357.   IF - Command Line: IF <variable number> <"text">
  358.         If whatever is in <variable number> equals <"text">, then
  359.         the script will continue. If it is not equal, it will search for
  360.         the next ENDIF and continue.
  361.         Example: 
  362.           IF 1 "Y"
  363.           display "Yes."
  364.           ENDIF
  365.  
  366.   WRITEANSWER - Command Line: WRITEANSWER "<text>" <variable number>
  367.         This will write <text> into the message followed by whatever
  368.         is in <variable number>.
  369.         Example: ask "What is your name: " 1 30
  370.  
  371.  WRITEANSWER "Name:" 1
  372.         This will write Name: followed by the users answer into the message.
  373.  
  374.   QUIT - Command Line: QUIT
  375.         This will quit the script and return to the editor.
  376.  
  377.   A script is a plain text file with 1 command per line. Any line
  378.   beginning with a ; is a comment that SFAME will ignore. The purpose of
  379.   the scripts is to help make it easier for callers to use some of the
  380.   services available on the Internet. Some Internet services, like
  381.   requesting files, can take commands the caller might not remember. By
  382.   using a script, you can prompt the caller for a file name, caller name
  383.   or any other information. Then the script can add the other commands,
  384.   addresses or other information needed. The variable 0 contains the users
  385.   Internet address in the form firstname.lastname@bbsname.com where
  386.   bbsname.com is replaced with your Internet address entered in the CONFIG
  387.   program. You can then use the script line:
  388.  
  389.   WRITEANSWER "Address: " 0
  390.  
  391.   This will put the text Address: followed by the users Internet address
  392.   in the message. I'm including some sample scripts in the file SCRIPTS.ZIP
  393.   to help understand how they work. Scripts can be a powerful and easy
  394.   way for your users to access features of the Internet. Scripts can
  395.   be used for other purposes than Internet features.
  396.  
  397.   When you choose option 4 to edit scripts, you will be asked if you would
  398.   like to create the SCRIPTS.DAT file. Choose YES to continue. You will
  399.   next see the list of scripts. When viewing this list, you can choose
  400.   <A> to add a new script, <D> to delete a script, or you can enter the
  401.   number of the script you would like to edit. Since the list is probably
  402.   blank, choose <A> to add a script. You will then be prompted for the
  403.   script files name. This should be the file name WITHOUT the .scr extension.
  404.   Next, you will be asked for a description for this script. You have up to
  405.   50 characters for a description. This description is displayed to the
  406.   caller when selecting a script. Next is the minimum security needed to
  407.   use this script. Next is the group number this script can be used in.
  408.   Set this to 0 if the script is available in all groups. The last prompt
  409.   asks for the conference this script can be used in. Set this to 0 if
  410.   you want to script available in all conferences. You should now see the
  411.   listing of scripts which includes the script you just added. Choose <Q>
  412.   to return to the CONFIG main menu.
  413.  
  414.   Option 5 on the main menu will allow you to setup the QWK settings used
  415.   by SFAME when making a QWK packet. The options are:
  416.  
  417.   <A> QWK Packet Name  - This is the name used for the QWK packet.
  418.                          It can be up to 8 characters and doesn't
  419.                          include the .QWK extension.
  420.  
  421.   <B> BBS Name         - This is your BBS name.
  422.  
  423.   <C> BBS City         - This is the city where your BBS is located.
  424.  
  425.   <D> BBS Phone        - This is your BBS phone number.
  426.  
  427.   <E> Max QWK Packet Size - This is the maximum number of messages that
  428.                          can be placed in a single .QWK packet. Set this
  429.                          to 0 to disable the QWK packet feature. Refer to
  430.                          the Reader section, option A below for more
  431.                          information on the QWK packets.
  432.  
  433.   <Q> Quit             - This will return you to the CONFIG main menu.
  434.  
  435.   Option 6 on the main menu will allow you to edit the files attached to
  436.   messages. This will list the files along with some other information.
  437.   If you choose D, you will be prompted for a file number to delete. If
  438.   the file is already marked DELETED, you can choose to un-delete the file.
  439.  
  440.   Option 7 will allow you to enter the nodelist information. You can specify
  441.   information for 2 nodelists which SFAME will use when you want to search
  442.   a nodelist. The options are:
  443.  
  444.   <A> Nodelist 1 Filename - This is the path\filename of the first nodelist.
  445.                             If this is a Fidonet style nodelist, don't
  446.                             include a file extension and SFAME will use the
  447.                             most recent nodelist. If you include a file
  448.                             extension, SFAME will search that file.
  449.  
  450.   <B> Type Of Nodelist - This is the type of nodelist 1. Select 1 for a SFNET
  451.                          nodelist, 2 for Circuitnet, or 3 for a Fidonet
  452.                          style nodelist. The Circuitnet list setting is for
  453.                          the orignal type of Circuitnet nodelist. If your
  454.                          using Fidonet to transfer Circuitnet mail, set
  455.                          the nodelist type to 3. The Fidonet setting is
  456.                          for any nodelist the uses the Fidonet nodelist
  457.                          format. It can be a nodelist for any network, not
  458.                          just Fidonet.
  459.  
  460.   Options C and D let your change the above settings for a second nodelist.
  461.  
  462.  
  463.   <Q> Quit            - This will return you to the CONFIG main menu.
  464.  
  465.  
  466.   Option 8 on the CONFIG main menu will allow you to edit the help records
  467.   SFAME displays when you press Ctl-Z. Press A through F to edit a line in
  468.   the record. Press + or - to move between records and Q to quit. You can
  469.   also press V to see what the display will look like in SFAME. The Ctl-Z
  470.   option is available at all SFAME prompts except the ones in the editor.
  471.  
  472.   Option 9 will allow you to specify conferences which don't allow taglines
  473.   to be added to messages. Some Fidonet echos do not allow taglines to be
  474.   added to messages. Choose A to add or D to delete a conference. You can
  475.   also enter the number next to a conference to edit an existing record.
  476.   When you choose to add or edit a record, you will see a menu to set the
  477.   group and conference number for this record. Choose A to edit the group
  478.   number or B to edit the conference number. When SFAME saves a message,
  479.   it will check this file for the conference the message will be saved in.
  480.   If the group and conference are found, no tagline will be added to the
  481.   end of the message.
  482.  
  483.   Option 10 will allow you to enter up to 10 co-sysop names. Choose A to
  484.   add or D to delete a name from the list. You can also select the number
  485.   next to the name to edit the name. When a user enters a message to the
  486.   Sysop, SFAME will display the list of sysops and let the user select one.
  487.   The list of sysops is only displayed for local messages to Sysop.
  488.  
  489.   The last option on the CONFIG main menu is Q which will exit the program.
  490.  
  491.   The CONFIG program has 2 command line parameters which can be used.
  492.   They are /CLEAN and /PACKFA. The /CLEAN option will read each name in
  493.   the CALLER.DAT file and check the SFUSERS.PTR file to make sure the
  494.   caller has not been deleted. If the callers name is not found in the
  495.   SFUSERS.PTR file, it is removed from the CALLER.DAT file. The CALLER.DAT
  496.   file contains the callers configurable settings used by SFAME.
  497.  
  498.   The /PACKFA option will pack the ATTACHES.DAT of files that have been
  499.   marked deleted and files that are older than the Days To Keep File Attaches
  500.   setting. It will also delete the file if it is not attached to another
  501.   message. The /CLEAN option should be about once a week and the /PACKFA
  502.   option should probably be run everyday to help free up disk space.
  503.  
  504.   If you followed the above steps, you should now be ready to run SFAME.
  505.   To run SFAME use the command line:
  506.  
  507.     SFAME <drop file>
  508.  
  509.   The <drop file> must be SFMESS.DAT, SFMAIN.DAT, SFFILE.DAT, SFDOORS.DAT,
  510.   or SFSYSOP.DAT You can also use the SCAN option to scan for new mail. 
  511.   Example:
  512.  
  513.     SFAME SFDOORS.DAT SCAN
  514.  
  515.   This will enter SFAME and start scanning for mail. You can then reply
  516.   to any messages found. The SCAN option should be used in your SFLOGON.BAT
  517.   instead of using SPITFIRE's message scan.
  518.  
  519.   If you are using SFAME locally, use the command line:
  520.  
  521.     SFAME
  522.     or
  523.     SFAME SCAN
  524.  
  525.   After the new caller screen, you should now be at the SFAME main menu.
  526.   From this menu you can choose the following options:
  527.  
  528.   <C> Change Conference - This will allow you to select a conference
  529.                          number or list available conferences.
  530.  
  531.   <D> Change Group     - This will allow you to select a group or list
  532.                          available groups.
  533.  
  534.   <L> List Messages    - This will list the messages in the current
  535.                          conference. You can use your arrow keys to
  536.                          move up/down the list and to the next/previous
  537.                          page. Press ENTER to read the message at the
  538.                          ">" cursor.
  539.  
  540.   <R> Read Messages    - This will prompt you for a message number to
  541.                          read. You can enter a message number, choose
  542.                          L to go to your last read message or press
  543.                          ENTER to list messages.
  544.  
  545.   <E> Enter Message    - This will prompt you for the conference you want
  546.                          the message saved in, who to send the message to
  547.                          and some other information. If you leave the
  548.                          Subject field blank, it will cancel the message.
  549.                          You will then see the blank editor screen where
  550.                          you enter your message. The editor commands are
  551.                          explained later.
  552.  
  553.   <A> Alter Conference Queue - This menu is the same as used by SPITFIRE.
  554.                          Refer to your SPITFIRE manual for help with the
  555.                          available options.
  556.  
  557.   <B> Alter Group Queue - This works the same as the Alter Conference Queue
  558.                          menu. All groups in your group queue will be
  559.                          scanned for new mail at logon.
  560.  
  561.   <S> Scan For Your Mail - This will scan the message base for messages
  562.                          to your name or your alias. You can also choose
  563.                          to scan for messages From you or your alias.
  564.                          SFAME will either scan all message conferences
  565.                          or just the conferences in your queue depending
  566.                          on the setting you choose in your Caller Settings.
  567.                          SFAME will stop scanning for messages when it
  568.                          reaches 200 messages found for the user. It will
  569.                          then ask if you want to read your messages now
  570.                          and sysops will be asked if they want messages
  571.                          marked Read (preview). You can stop the message
  572.                          scan by pressing any key. If you choose to read
  573.                          your messages, you will next see the reader screen
  574.                          with the message header information and a message
  575.                          displayed. Choose H to list the available options.
  576.                          Refer to the Message Reader section of this file
  577.                          for more information on the options. Choose R if
  578.                          you would like to reply to the current message.
  579.                          Refer to the Message Reader section for more
  580.                          information about replying to messages.
  581.  
  582.   <I> Change Caller Settings - This will allow the user to configure some
  583.                          of SFAME's settings. When you select I, you will
  584.                          see a listing of the current settings with a
  585.                          letter to select if you want to change a setting.
  586.                          Options A,B,C, and D will allow you to select the
  587.                          different colors SFAME will use. Set option E to
  588.                          OFF if you don't want to use color. Option F will
  589.                          allow you to select the style of borders used
  590.                          when you quote a message. Select 5 to design your 
  591.                          own quote box design. These are the macros you can
  592.                          use in your quote box:
  593.                            @F  : Replaced with the name in the From: field
  594.                                  of the message you are replying to.
  595.                            @T  : The name in the To: field.
  596.                            @Y  : Your name or alias, whichever you're using.
  597.                            @S  : The text in the Subject: field.
  598.                            @OD : The date of the original message.
  599.                            @OT : The time of the original message.
  600.                            @CD : The current date.
  601.                            @CT : The current time.
  602.  
  603.                          The @F, @T, and @Y macros are padded to fill 20
  604.                          spaces. The @S macros is padded to 25 spaces.
  605.                          Padding the text is necessary to allow your quote
  606.                          box to work with text of different lengths.
  607.                          Option G will allow you to specify if SFAME
  608.                          should scan all or your queued message conferences
  609.                          when it scans for messages. Options H and I will
  610.                          allow you to edit taglines which you can use in
  611.                          your messages. How to insert taglines is decribed
  612.                          in the Editor section. Option J will allow you to
  613.                          select an alias. The following is what SFAME checks
  614.                          when a user selects an alias:
  615.                            1. The alias can't be "SYSOP".
  616.                            2. The alias can't be the sysop's real name.
  617.                            3. The alias can't be the name of another caller.
  618.                            4. The alias can't be an alias already used by
  619.                               another user.
  620.                            5. The alias can't be used if found in the
  621.                               SPITFIRE JOKER.DAT file.
  622.                          The user will be allowed to select an alias but
  623.                          can only use it if you have the group configured
  624.                          to allow aliases. Option K lets you specify which
  625.                          method SFAME uses when listing message conferences.
  626.                          Choose 1 if you only want to display the name of
  627.                          each conference. Choose 2 if you also want to
  628.                          display the number of messages in each conference.
  629.                          Choose 3 if you want to display the number of
  630.                          new messages in each conference. Option 1 is the
  631.                          fastest and 3 is the slowest. Option L lets you
  632.                          design a quote header that will be placed above
  633.                          any text you quote when replying to a message.
  634.                          These are the macros you can include in your
  635.                          qoute header line:
  636.                            @F  : Replaced with the name in the From: field
  637.                                  of the message you are replying to.
  638.                            @FF : The First name in the From: field.
  639.                            @FL : The Last name in the From: field.
  640.                            @T  : The name in the To: field.
  641.                            @TF : The First name in the To: field.
  642.                            @TL : The Last name in the To: field.
  643.                            @Y  : Your name or alias, whichever you're using.
  644.                            @S  : The text in the Subject: field.
  645.                            @D  : The date of the original message.
  646.                            @TM : The time of the original message.
  647.  
  648.                          Example:  @F said to @T about @S on @D...
  649.                          If the original message was from Sysop to All Callers
  650.                          about SFAME written on 01-01-95 then the line placed
  651.                          above the quoted text would be:
  652.                          Sysop said to All Callers about SFAME on 01-01-95...
  653.                          You can combine text and macros to design any qoute
  654.                          header you like. You can also leave the quote header
  655.                          empty if you don't want one placed in your message.
  656.                          Option M lets you edit your address book if you have
  657.                          enabled them in the CONFIG program. You can store up
  658.                          to 20 addresses which can be used when entering a
  659.                          message.
  660.  
  661.   <H> Help Using SFAME - This will display the text file SFAME.HLP if
  662.                          found. It will also ask the user if they would
  663.                          like to download a copy. The SFAME.HLP file is
  664.                          a plain text file which you can edit. It describes
  665.                          how to use some of the features of SFAME.
  666.  
  667.   <Q> Quit             - This will return the user to SPITFIRE.
  668.  
  669.   <O> Menu Extension   - If you have entered a name for the Main Menu
  670.                          Extension in the CONFIG program, then option O
  671.                          will be displayed. SFAME will then run the
  672.                          NODE#.BAT or NODE.BAT. Refer to around line 70
  673.                          above for information on the NODE.BAT file.
  674.  
  675.   <G> Goodbye          - If you have set Main Menu Logoff to TRUE in the
  676.                          CONFIG program, this option will be shown and
  677.                          the caller will be logged off. The GOODBYE.BBS/CLR
  678.                          file will be shown if found in the SPITFIRE
  679.                          display directory.
  680.  
  681.   <F> Download QWK Packet - If the caller has selected any messages to
  682.                          be placed in a QWK packet, this will allow them
  683.                          to download it if they have enough time.
  684.  
  685.   <Ctl+Z> Help         - You can press Ctl+Z from any prompt for a help
  686.                          message describing the prompt. You can edit the
  687.                          text of the help messages in the CONFIG program.
  688.                          The Ctl+Z help is not available in the editor.
  689.  
  690.   MESSAGE READER
  691.   ──────────────
  692.  
  693.   You can read messages by choosing R or L from the main menu. After
  694.   selecting which message to read, you will then see the message information
  695.   displayed at the top of the screen and the message text below. The
  696.   header also contains 6 flags, N S T P D R, which represent the status
  697.   of each message. The N stands for a Netmail message. The S means the
  698.   message has been Sent netmail. The T means the message is Threaded to
  699.   another message. The P means this is a Private message. D stands for
  700.   Deleted and R means the message has been Received. You will also see
  701.   <First> or <Last> in the header if the current message is the first or
  702.   last message in the conference. If there is a file attached to the
  703.   message, you will see [File] displayed in the header. You should be able
  704.   to understand the rest of the information in the header. When reading
  705.   messages, you have the following options:
  706.  
  707.   <A> Add Message To QWK Packet - This will place the current message into
  708.                          a QWK packet the caller can download by choosing
  709.                          F from the Main Menu. This option will allow you
  710.                          to save a copy of the message. You can't reply
  711.                          to the messages and upload a .REP packet to SFAME.
  712.                          Since the .QWK packet does not store which group
  713.                          a message is from, SFAME would not know where to
  714.                          put the replies. The QWK packet can say the message
  715.                          is from conference #5 but if you have 2 groups, you
  716.                          will have 2 conference #5's and SFAME would not
  717.                          know where the reply belongs. You might not
  718.                          understand the above until you understand groups.
  719.                          Just remember SFAME doesn't accept .REP packets.
  720.  
  721.   <B> Edit Current Message - This will allow the user to edit a saved
  722.                          message if the message is From the user. You
  723.                          cannot edit a message that has already been received
  724.                          or sent by netmail.
  725.  
  726.   <C> Change Conference - This will allow you to select a new conference
  727.                          to read messages in. You will be prompted for the
  728.                          conference and message number to read.
  729.  
  730.   <D> Toggle Deleted   - This will toggle whether a message is deleted.
  731.  
  732.   <E> Enter Message    - This will allow you to enter a message. It will
  733.                          first ask for the conference to save the message
  734.                          in. Then SFAME will ask who to send the message
  735.                          to. If the message is not marked as NetMail, the
  736.                          To: name must be a local caller and the conference
  737.                          must be in their conference queue. You can press
  738.                          ENTER if you would like the message sent to All
  739.                          Callers. You can also send the message to * if
  740.                          you would like a copy sent to every caller. You
  741.                          can also use * 10 20 if you would like a copy
  742.                          sent to all callers with a security level of
  743.                          10 or 20.
  744.                          Examples: At the "Message To" prompt enter:
  745.                            *         to send a copy to all callers
  746.                            * 10 15   to send a copy to all callers with a
  747.                                      security level of 10 or 15.
  748.                          You can specify up to 5 security levels to send
  749.                          the message to. Only users with sysop security
  750.                          can send a message To: *. You can also enter A
  751.                          at the Message To: prompt if you want to view your
  752.                          address book. If you want to use an address stored
  753.                          in your book, enter the tag letter to the left of
  754.                          the address. Choose L from the Caller Settings menu
  755.                          to edit your address book. You must also have enabled
  756.                          the address book feature in the CONFIG program.
  757.  
  758.   <F> Follow Message Thread - This will allow you to go to the beginning
  759.                          of the message thread, or read forward or backward
  760.                          in the thread. Threaded messages are messages in
  761.                          the same conference with the same subject and
  762.                          marked as threaded.
  763.  
  764.   <G> Goto Last Message Read - This will search for the last message you've
  765.                          read in the current conference.
  766.  
  767.   <H> Help             - This will display a help screen of the message
  768.                          reader's options.
  769.  
  770.   <I> Non-Stop Capture - This will display messages non-stop. It will
  771.                          pause every 25 messages and ask if you want
  772.                          to continue. You can also press any key to stop.
  773.  
  774.   <J> Download Attached File - If there is a file attached to the current
  775.                          message, the user can download the file if they
  776.                          have enough time. If your using SFAME locally, you
  777.                          will be asked for the directory to copy the file.
  778.                          You must have DSZ.EXE or .COM in your path to
  779.                          allow downloads. The user can select X, Y, or ZModem.
  780.  
  781.   <K> Steal Tagline    - This will let you copy a tagline from the current
  782.                          message to your Taglines.txt file. When you choose
  783.                          K, you will be asked for the line number that
  784.                          contains the tagline. After you enter a number,
  785.                          you will see that line displayed and you will be
  786.                          allowed to edit the line. You can use the arrow
  787.                          keys or the home/end keys to move the cursor. 
  788.                          Press ENTER when your done editing the tagline.
  789.                          SFAME will ask if you want the line added to 
  790.                          Taglines.txt. Only users with sysop security
  791.                          can steal a tagline.
  792.  
  793.   <L> List Messages    - This will list messages available to the user.
  794.  
  795.   <M> Message Number   - This will allow you to enter a message number to
  796.                          read. You can press Enter to list messages or
  797.                          choose L for the last message you've read.
  798.  
  799.   <N> Toggle Netmail Message - This will toggle whether a message will be
  800.                          sent netmail.
  801.  
  802.   <O>, <F10> Menu Of Options - This will display the options in the message
  803.                          reader with a number you can select for each
  804.                          option. It might be easier to use the F10 menu
  805.                          instead of having to choose H - Help if you
  806.                          can't remember an option's selection letter.
  807.  
  808.   <P> Toggle Private Message - This will toggle whether a message is private.
  809.  
  810.   <Q> Quit to Main Menu - This will return you to the SFAME main menu.
  811.  
  812.   <R> Reply To Message - This will allow you to reply to the current
  813.                          message. You first will be asked where you would
  814.                          like the message saved. You will then be asked
  815.                          if you want the message sent to the To: or From:
  816.                          name. At the "Message To" prompt, enter T, F or
  817.                          press ENTER to send the message to All Callers.
  818.                          You can also enter a callers name to send the
  819.                          reply to. You can send the reply to * if you
  820.                          want a copy sent to every caller. The * is
  821.                          described in the option E help above.
  822.  
  823.   <S> Toggle NetMail Sent - This will toggle whether a netmail message
  824.                          has been sent. This option is only available
  825.                          to users with sysop security.
  826.  
  827.   <T> Text Search      - This will ask you for the text to search for and
  828.                          which message fields to search. The first message
  829.                          with the text found will be displayed.
  830.  
  831.   <U> Repeat Text Search - This will search for the next message that
  832.                          contains the text in the fields choosen with
  833.                          option T - Text Search.
  834.  
  835.   <V> View RIP Message - This will first write the current message to the
  836.                          text file VIEWRIP.RIP. If will then run the batch
  837.                          file VIEWRIP.BAT with VIEWRIP.RIP as parameter %1.
  838.                          Your VIEWRIP.BAT file should contain the line:
  839.                          <program name> %1
  840.                          Replace the <program name> with your RIP viewer
  841.                          program name. This option is only for local users.
  842.  
  843.   <W> Copy Message     - This will copy the current message to any
  844.                          conference. If a file is attached to the message,
  845.                          the information is also copied. This option is
  846.                          only available to users with sysop security.
  847.  
  848.   <X> Export Message   - This will export the current message to a text
  849.                          file or the printer. If the file already exists,
  850.                          you can append or overwrite the original. You can
  851.                          also add the header information to the copy
  852.                          exported.
  853.  
  854.   <Y> Toggle Message Read - This will toggle whether a message has been
  855.                          read or received by the message To: name.
  856.  
  857.   <Z> Move Message     - This will copy the current message to any
  858.                          conference and mark the original as deleted. If
  859.                          a file is attached to the message, the information
  860.                          is updated with the new message conference and
  861.                          number. This option is only available to users
  862.                          with sysop security.
  863.  
  864.   <[>, <]> Prev/Next Conference In Queue - Choosing [ will take you to
  865.                          the previous conference in your queue. Choosing ]
  866.                          will take you to the next conference in your queue.
  867.  
  868.   <O>+<20>             - This will let you place the To: or From: name of the
  869.                          current message in your address book. You will first
  870.                          be asked which name. You will then see your address
  871.                          book. Choose the tag letter of the entry you want to
  872.                          place this address. This option is only available by
  873.                          first selecting the <O> or <F10> menu then #20.
  874.  
  875.  
  876.   You should be able to understand the rest of the options that are listed
  877.   when choosing H in the reader. Most allow you to move between messages or
  878.   scroll the message your reading. You can use the arrow keys, the page
  879.   up/down, and home/end keys to scroll through a message. To go to the
  880.   next message you can use either 6, +, or the right arrow. To go to the
  881.   previous message, you can use 4, -, or the left arrow.
  882.  
  883.  
  884.   MESSAGE EDITOR
  885.   ──────────────
  886.  
  887.   When you select to enter a message, after you've entered the needed
  888.   information, you will then be at the blank editor screen. The screen
  889.   displays 20 lines of up to 74 characters each. The SFAME editor has
  890.   word-wrapping so when you reach the end of a line, SFAME will automatically
  891.   wrap the current word to the next line and you can continue typing. All
  892.   users can use the Ctrl+ key options but the Alt+ and other keys can only
  893.   be used by local users or while in DOORWAY mode. Below are the available
  894.   options when entering a message:
  895.  
  896.   <Ctrl-S> - This moves the cursor left 1 character. You can also use
  897.              the left arrow key.
  898.  
  899.   <Ctrl-D> - This moves the cursor right 1 character. You can also use
  900.              the right arrow key.
  901.  
  902.   <Ctrl-Left Arrow> - Moves to beginning of previous word.
  903.  
  904.   <Ctrl-Right Arrow> - Moves to beginning of next word.
  905.  
  906.   <Ctrl-W> - Move to Start of line. You can also use the HOME key.
  907.  
  908.   <Ctrl-T> - Move to End of line. You can also use the END key.
  909.  
  910.   <Ctrl-I> - Move to next tab stop. You can also use the TAB key.
  911.  
  912.   <Ctrl-E> - Move Up 1 line. You can also use the UP ARROW key.
  913.  
  914.   <Ctrl-O> - Move Down 1 line. You can also use the DOWN ARROW key.
  915.  
  916.   <Ctrl-J> - Move up 1 page. You can also use the PAGE UP key.
  917.  
  918.   <Ctrl-K> - Move down 1 page. You can also use the PAGE DOWN key.
  919.  
  920.   <Ctrl-G> - This will allow you to goto any line number in the message.
  921.  
  922.   <Ctrl-B> Block Edit  - This will allow you to move, copy or delete a
  923.                          block of text. Move the cursor to the first line
  924.                          you want in the block and press CTRL-B. You then
  925.                          can move the cursor down to the last line you
  926.                          want in the block and press CTRL-B again. You
  927.                          will then be asked if you want to move, delete,
  928.                          or copy the block. If you choose to move or copy
  929.                          the block, you will then select the line where
  930.                          you want the block placed and press ENTER.
  931.  
  932.   <Ctrl-N> - This will insert a blank line at the cursor positions line
  933.              number. If there is text on the last line, you cannot insert
  934.              a line.
  935.  
  936.   <Ctrl-Y> - This will delete the entire current line.
  937.  
  938.   <Ctrl-L> - This will insert the last line deleted using CTRL-Y. If there
  939.              is text on the last line, you cannot insert a line.
  940.  
  941.   <Ctrl-F> - This will allow you to fill the entire line with a character.
  942.              If there is text on the last line, you cannot fill a line with
  943.              characters.
  944.  
  945.   <Ctrl-R> - This will delete all text from the cursor position to the
  946.              end of the line.
  947.  
  948.   <Ctrl-H> - This is the same as using the BACKSPACE key.
  949.  
  950.   <Ctrl-C> - This will delete the character at the cursor. This is the
  951.              same as the DELETE key.
  952.  
  953.   <Ctrl-P> - This will toggle between insert and overwrite mode. This is
  954.              the same as the INSERT key.
  955.  
  956.   <Alt-D> - This will delete the word to the right of the current word.
  957.  
  958.   <Alt-H> - This will insert the name of who the message is being sent To:.
  959.  
  960.   <Alt-A> - This will toggle whether a message is public or private.
  961.  
  962.   <Alt-N> - This will allow you to change the message To: name.
  963.  
  964.   <Alt-S> - This will allow you to change the message subject.
  965.  
  966.   <Alt-K> - This will allow you to edit the routing information.
  967.  
  968.   <Alt-L> - If aliases are allowed, this will allow you to choose between
  969.             using your real name or alias for the message.
  970.  
  971.   <Alt-M> - This will allow you to edit the carbon copy list. You can have
  972.             up to 9 carbon copies. If the conference allows message routing,
  973.             you will also be asked if you would like to route the message.
  974.             You can route the original and each carbon copy to a different
  975.             address. If you want to edit one of the names in the carbon copy
  976.             list, first delete the name and re-enter it with the new
  977.             information.
  978.  
  979.   <Alt-F> - This will allow you to route this message to any node. The
  980.             node number you specify will be added to the beginning of
  981.             the message subject. This is where most Spitfire mail scanners
  982.             check for routing info. You can also choose <N> to remove a
  983.             node number from the message subject.
  984.  
  985.   <Alt-G> - This will allow you to route this message through SFNET. If
  986.             you are replying to a message, SFAME will check the original
  987.             message for a SFNET address and ask if you want it routed there.
  988.             At the SFNET address prompt, you either enter a new address,
  989.             choose N to clear the current address or choose Q to return
  990.             to the editor and keep the current address.
  991.  
  992.   <Alt-X> - This will allow you to insert one of the taglines you entered
  993.             in the Caller Settings menu. The tagline can be any text you
  994.             often use in a message but don't want to type for every message.
  995.  
  996.   <Ctrl-Q> - If you are replying to a message, this will allow you to quote
  997.              the original. In the quote screen, you use the 2, 8 keys to
  998.              move the > up or down. You can also use the 3, 9 keys to move
  999.              up or down 1 page. If local, you can use the up/down arrows
  1000.              and the pageup/down keys. If you want to quote a line, move
  1001.              the > to the line and press ENTER or the SPACE bar. Press W
  1002.              to toggle word wrapping on/off. When your done, choose D to
  1003.              return to the editor. If you decide not to quote the original,
  1004.              choose C to cancel the quote.
  1005.  
  1006.   <Ctrl-U> - This will allow you to upload a text file that will be placed
  1007.              in your message. The file must be uncompressed and any line
  1008.              longer than 74 characters is cut. If you are using SFAME
  1009.              locally, you can use this to import a text file into your
  1010.              message. Local users have 80 characters for the path\file name
  1011.              and remote users have 12 characters for the file name only.
  1012.              You must have DSZ.EXE or .COM somewhere in your path to allow
  1013.              uploads. The user will be able to choose X, Y, or ZModem.
  1014.              If your using SFAME locally, you can press ENTER at the
  1015.              prompt asking for a file name and SFAME will check for the
  1016.              file SFMSG.TXT in your work directory. If found, SFAME will
  1017.              insert the SFMSG.TXT file.
  1018.  
  1019.   <Ctrl-Z> - This will display the help file EDITOR.HLP. This is a plain
  1020.              text file which lists the editor commands and keys to use.
  1021.  
  1022.   <Escape> - This will exit the editor. When you select this, you will be
  1023.              asked if you want to <A>bort, <C>ontinue, or <S>ave the message.
  1024.              If you allow files attached to messages, you will also see
  1025.              an option Attach <F>ile. <A>bort will cancel the message without
  1026.              saving a copy. <C>ontinue will allow you to continue entering
  1027.              the message. <S>ave will save the message. Attach <F>ile will
  1028.              allow you to attach a file to the message. Local users will
  1029.              have 80 characters to enter a path\file name of the file to
  1030.              attach. Remote users have 12 characters for the file name.
  1031.              You must have DSZ.EXE or .COM somewhere in your path to allow
  1032.              uploads. The user will be able to choose X, Y, or ZModem.
  1033.              SFAME will check that there is at least as much free disk
  1034.              space as you specified in the CONFIG program before allowing
  1035.              an upload. When the upload is completed, the file is copied
  1036.              to the file attach directory. SFAME uses the DOS COPY command
  1037.              to copy files so you might see DOS's "1 file copied" message.
  1038.              Only 1 file can be attached to a message. You can also use
  1039.              the ESCAPE key to exit the editor.
  1040.  
  1041.   <Ctrl-A> - This will list a menu of the AutoMessage scripts available.
  1042.              If the user selects a script, any text placed into the message
  1043.              by the script will be placed at the cursor position when
  1044.              Ctrl-A was selected.
  1045.  
  1046.   <Ctrl-V> - This will show you some information about the current message.
  1047.  
  1048.   <Alt-V> - This will display a chart of the ASCII characters and codes for
  1049.             #128 through #254. The characters can be used by pressing
  1050.             ALT+ the code below the character.
  1051.  
  1052.   <Alt-B> - This will save a copy of the message to a text file. This
  1053.             option is available only to local users.
  1054.  
  1055.   <Ctrl-X>, <F10> - This will display a menu of options. You can choose
  1056.             an option by entering the number next to it. Using this menu
  1057.             is probably easier than remembering the Ctrl+ and Alt+ keys.
  1058.  
  1059.   There are a few options available only by using the F10 menu. They are:
  1060.  
  1061.   <11> - This will place your name in the message.
  1062.  
  1063.   <20> - This will allow you to route a message to a Circuitnet node.
  1064.          If you are replying to a message, this will check the original
  1065.          for a CircuitNet address. SFAME will add >> + the address to
  1066.          the message subject.
  1067.  
  1068.   <27> - This will display a menu of the SPITFIRE macros you can place
  1069.          in a message.
  1070.  
  1071.   <28> - This will allow you to search a nodelist for any text. You will
  1072.          first be asked which of the 2 nodelists to search. You then
  1073.          enter the text to search for. If you want to display the entire
  1074.          nodelist enter ALL at the prompt asking for the text to search
  1075.          for. If SFAME finds a line with the text, it will display the
  1076.          line with a tag letter. If you choose the tag letter, the address
  1077.          found on that line will be used to route the message.
  1078.  
  1079.   <29> - SFAME will shell to the file SPELL.BAT. The SPELL.BAT file is
  1080.          explained above. When you return to SFAME, you will see the editor
  1081.          screen with a new copy of your message which will contain any
  1082.          changes made in the spell checker. You can then continue to edit
  1083.          the message. You will also be asked if you want to spell check
  1084.          your message before it is saved.
  1085.  
  1086.   When saving a netmail message, first, SFAME will check for a text file
  1087.   called TAGLINES.TXT. The TAGLINES.TXT file is a plain text file which
  1088.   contains taglines that are added to messages. Place the taglines 1 per
  1089.   line and a line can't be longer than 75 characters. If you've registered
  1090.   SFAME, a tagline will be placed at the end of the message. Next, SFAME
  1091.   will check for a file called BBSNAME.DAT in your SPITFIRE work directory.
  1092.   If found, the first line will be added to the end of the message.
  1093.  
  1094.  
  1095.   SFCALLER MESSAGES
  1096.   ─────────────────
  1097.  
  1098.   SFAME supports the SPITFIRE SFCALLER message feature. Any user with
  1099.   a sysop security level can send a message to SFCALLER. A message to
  1100.   SFCALLER can be read by any caller. When a user scans for new messages,
  1101.   any messages to SFCALLER will be marked for the user to read if the
  1102.   message was written since the users last login. The name SFCALLER
  1103.   is replaced with the users name in the message header and when
  1104.   listing messages. Any user with a sysop security level will see the
  1105.   name SFCALLER in the message header instead of their actual name. This
  1106.   should help the sysop keep track of any SFCALLER messages. Only a user
  1107.   with a sysop security level can delete a message to SFCALLER. You can
  1108.   also send security specific SFCALLER messages by adding a security level
  1109.   to the SFCALLER name. A message to SFCALLER15 can only be read by users
  1110.   with a security level of 15. When entering a message in SFAME, you can
  1111.   place SFCALLER names in the carbon copy fields. This will allow you to
  1112.   send up to 10 security specific SFCALLER messages. The SFCALLER feature
  1113.   should be used instead of the SFAME message to * feature. When you send
  1114.   a SFAME message to *, it will write a message to every caller. When you
  1115.   send a message to SFCALLER, only 1 copy of the message is saved.
  1116.  
  1117.  
  1118.   SYSOP FUNCTION KEYS
  1119.   ───────────────────
  1120.  
  1121.   There are a few sysop function keys available in SFAME. They
  1122.   operate the same as in SPITFIRE.
  1123.  
  1124.   <Alt+F1> - This will log off the user and display the file
  1125.              NEEDSYS.BBS/CLR if found in your SPITFIRE display directory.
  1126.              If the file is not found, a message will be displayed.
  1127.  
  1128.   <Alt+F2> - This will log off the user without displaying a message.
  1129.  
  1130.   <Alt+C> - This will enter and exit chat mode. You can't chat with a
  1131.             caller while editing a message.
  1132.  
  1133.   <Alt+J> - This will cause SFAME to drop to dos. It will also swap out
  1134.             of memory if set in the CONFIG program. Type EXIT to return
  1135.             to SFAME.
  1136.  
  1137.   <F4> - This will toggle the printer on/off in SPITFIRE. If the SPITFIRE
  1138.          setting is OFF, then SFAME will not use the printer.
  1139.  
  1140.   <F6> - This will decrease the callers time by 5 minutes.
  1141.  
  1142.   <F7> - This will increase the callers time by 5 minutes.
  1143.  
  1144.  
  1145.   SFAME WORK FILES
  1146.   ────────────────
  1147.  
  1148.   These are the data and display files created and used by SFAME. The
  1149.   SFAME home directory refers to the directory where the SFAME.EXE and .OVR
  1150.   files are placed. SFAME uses the following SPITFIRE control characters
  1151.   when displaying files. Refer to your SPITFIRE manual if you need more
  1152.   information about the control characters. The characters can be placed
  1153.   in display files, or messages.
  1154.  
  1155.   Note: If you want to place a control character in a message using the
  1156.   SFAME editor, choose F10 for the Editor menu, then choose 28 for the
  1157.   control character menu. The reason for the extra menu is because if you
  1158.   enter ^D at the editor screen, SFAME will not know if you want to use the
  1159.   control character ^D or the editor feature ^D.
  1160.  
  1161.   Also, if you use a control character in a message, SFAME will display
  1162.   the information and not the control character. Example: If you put a ^V
  1163.   in your message, you will see your full name displayed but SFAME will
  1164.   store and save the ^V in the message. If your using SFAME locally, you
  1165.   will see the control codes. This is because of the direct screen writing
  1166.   used by SFAME.
  1167.  
  1168.           ^B (ASCII 02) - Inhibits the "More <y/n>" prompt.
  1169.           ^D (ASCII 04) - Displays caller's first name.
  1170.           ^E (ASCII 05) - Displays the subscription days left.
  1171.           ^F (ASCII 06) - Displays caller's city and state/province.
  1172.           ^J (ASCII 10) - Displays number of files uploaded by caller.
  1173.           ^K (ASCII 11) - Displays number of files downloaded by caller.
  1174.           ^L (ASCII 12) - Clears screen.
  1175.           ^O (ASCII 15) - Displays the caller's original log on date.
  1176.           ^P (ASCII 16) - Displays the "More <y/n>" prompt.
  1177.           ^Q (ASCII 17) - Displays the number of minutes allowed this log on.
  1178.           ^R (ASCII 18) - Displays the caller's phone number.
  1179.           ^S (ASCII 19) - Displays the date of the caller's last call.
  1180.           ^T (ASCII 20) - Displays the caller's password.
  1181.           ^U (ASCII 21) - Displays the caller's date of birth.
  1182.           ^V (ASCII 22) - Displays caller's full name.
  1183.           ^W (ASCII 23) - Displays the number of K uploaded.
  1184.           ^X (ASCII 24) - Displays the number of K downloaded.
  1185.           ^Y (ASCII 25) - Displays the caller's security level.
  1186.  
  1187.   The ^C, ^G, and ^N codes used by SPITFIRE are not used in SFAME.
  1188.  
  1189.   SFAME also supports the following SPITFIRE macros. While SFAME will
  1190.   correctly display the macros, you will need a version of SPITFIRE newer
  1191.   than 3.5 to use them in SPITFIRE.
  1192.  
  1193.           @PROMPTOFF@ - Inhibits the "More <y/n>" prompt.
  1194.           @FNAME@     - Displays caller's first name.
  1195.           @SUBDATE@   - Displays the subscription days left.
  1196.           @CITYSTATE@ - Displays caller's city and state/province.
  1197.           @UPLOADS@   - Displays number of files uploaded by caller.
  1198.           @DOWNLOADS@ - Displays number of files downloaded by caller.
  1199.           @CLS@       - Clears screen.
  1200.           @ORGLOG@    - Displays the caller's original log on date.
  1201.           @PROMPT@    - Displays the "More <y/n>" prompt.
  1202.           @LOGTIME@   - Displays the number of minutes allowed this log on.
  1203.           @PHONENUM@  - Displays the caller's phone number.
  1204.           @LASTCALL@  - Displays the date of the caller's last call.
  1205.           @PASSWORD@  - Displays the caller's password.
  1206.           @BIRTHDATE@ - Displays the caller's date of birth.
  1207.           @NAME@      - Displays caller's full name.
  1208.           @UPK@       - Displays the number of K uploaded.
  1209.           @DOWNK@     - Displays the number of K downloaded.
  1210.           @SLEVEL@   - Displays the caller's security level.
  1211.  
  1212.  
  1213.   CONF#.BBS/CLR - This file is displayed to a user when they choose to
  1214.                   enter a message in conference #. It is displayed after
  1215.                   the user selects which conference to save a message in
  1216.                   and before SFAME asks who to send the message to. It can
  1217.                   be used to tell the user how to address Internet EMail
  1218.                   or anything else you want to tell the user about the
  1219.                   conference. This file should be in the groups message
  1220.                   directory.
  1221.  
  1222.   EDITOR.HLP   - This is the text help displayed when you choose CTRL-Z in
  1223.                  the message editor. It is kept in the SFAME home directory.
  1224.  
  1225.   SFAME.HLP    - This is the help file displayed when you choose H from the
  1226.                  SFAME main menu. It is kept in the SFAME home directory.
  1227.  
  1228.   GROUP#.BBS/CLR - This file is displayed to the caller when they select
  1229.                    group #. Example: GROUP2.BBS/CLR will displayed when
  1230.                    a user enters group 2. This file is kept in the SFAME
  1231.                    home directory.
  1232.  
  1233.   GROUPS.BBS/CLR - This file can contain a display of the groups available.
  1234.                    When changing groups, SFAME will normally list the group
  1235.                    numbers and their description and the caller can select
  1236.                    which group to enter. By using the GROUPS.BBS/CLR screen,
  1237.                    you can create a display of the groups. SFAME allows 40
  1238.                    characters to describe a group. By using this display,
  1239.                    you can design a screen that can contain longer
  1240.                    descriptions. This file is kept in the SFAME home directory.
  1241.  
  1242.   MAINMENU.BBS/CLR - If SFAME finds this file, it will be displayed instead
  1243.                    the internal main menu. This file is kept in the SFAME
  1244.                    home directory.
  1245.  
  1246.   ATTACHES.DAT   - This file contains information about the files attached
  1247.                    to messages. Each group has its own ATTACHES.DAT file. It
  1248.                    is kept in the group directory.
  1249.  
  1250.   CALLER.DAT     - This file contains the caller settings that can be changed
  1251.                    by choosing I from the SFAME main menu. It is kept in the
  1252.                    SFAME home directory.
  1253.  
  1254.   COSYSOPS.DAT   - This file contains the names of any co-sysops you've
  1255.                    entered in the CONFIG program.
  1256.  
  1257.   GROUPS.DAT     - This file contains the setup information for each group.
  1258.                    It is kept in the SFAME home directory.
  1259.  
  1260.   NEWQUEUE.DAT   - This file is used by the SFAMEUQ.EXE utility which is
  1261.                    described later. When a user alters their message queue,
  1262.                    the new queue is written to this file. This file is written
  1263.                    to the SPITFIRE home directory.
  1264.  
  1265.   NOTAGS.DAT     - This file contains the conferences which you don't want
  1266.                    taglines used. Choose option 9 from the CONFIG menu to
  1267.                    edit the conferences in this file.
  1268.  
  1269.   SCRIPTS.DAT    - This file contains your script information. It is kept in
  1270.                    the SFAME home directory.
  1271.  
  1272.   SFAMEHLP.DAT   - This file contains the help records seen when you press
  1273.                    Ctl+Z in SFAME. You can choose menu option 8 of the CONFIG program
  1274.                    if you want to edit this file.
  1275.   
  1276.   ERRORS.LOG     - If an error occurs, it will be written to this file. If
  1277.                    this file exists, you should read it. It is used if a
  1278.                    needed file is not found or some other error occurs.
  1279.  
  1280.   SFAME.LOG      - If you don't specify a log file name in the CONFIG, SFAME
  1281.                    will write caller activity to this file. It is written
  1282.                    in the SFAME home directory.
  1283.  
  1284.   SFAME.CFG      - This is the main SFAME configuration file. It contains
  1285.                    the settings you select using the CONFIG program. It is
  1286.                    kept in the SFAME home directory.
  1287.  
  1288.   ALIAS.PTR      - This file contains all users and their alias if they use
  1289.                    one. When a caller enters SFAME, this file is scanned for
  1290.                    their settings instead of the scanning the CALLER.DAT file
  1291.                    which is slower. This file is also checked when a user
  1292.                    selects an alias. It is kept in the SFAME home directory.
  1293.  
  1294.   CONFQUE.#      - This file contains the callers conference queue for group
  1295.                    #. The file CONFQUE.2 contains the conference queues for
  1296.                    group 2. since SPITFIRE only stores 1 conference queue,
  1297.                    this allows the user to have a queue for each group. This
  1298.                    file is kept in the group directory.
  1299.  
  1300.   NODE# DIRECTORY - SFAME will create work directories called NODE# where
  1301.                     the # is the node number for the directory. Local users
  1302.                     will have a NODE0 directory. This directory is where
  1303.                     SFAME makes the .QWK packets and puts uploaded files.
  1304.                     When a user exits SFAME, this directory will be cleaned.
  1305.                     If there are some files left over after a caller, you
  1306.                     can delete them. If you create a .QWK packet locally,
  1307.                     it is kept in the NODE0 directory when you exit. The
  1308.                     NODE# directories are not removed when the user exits
  1309.                     but files in them are deleted.
  1310.  
  1311.   QWK DOORS
  1312.   ─────────
  1313.  
  1314.   You can use SFAME's Main Menu Extension to setup a QWK mail door. If
  1315.   you have more than 1 group, then your mail door will probably need a
  1316.   different configuration file for each group. Heres why. If a caller
  1317.   enters the mail door in group 1 and downloads BBSNAME.QWK, then goes
  1318.   to group 2 and uses the mail door and tries to download another packet
  1319.   called BBSNAME.QWK, the download will fail because the file already exists
  1320.   in the users DL directory. To fix this, you should include the group
  1321.   number in the QWK packet name. Group 1's name should be BBSNAME1.QWK,
  1322.   group 2's BBSNAME2.QWK, etc. Your mail door will probably need a different
  1323.   configuration file which contains the QWK packet name for each group.
  1324.   An easy way to name them is CONFIG.1, CONFIG.2, etc. When SFAME exits
  1325.   runs node.bat, it includes the group number as %1. In your node.bat
  1326.   file, you can then copy the CONFIG.%1 to the name used by your mail door.
  1327.   When a user uploads their reply packets, they will have to enter the
  1328.   mail door for each group. Using a mail door with more than 1 group
  1329.   can seem a little messy but its does work. I've included a sample
  1330.   NODE.BAT file that should help you understand this.
  1331.  
  1332.  
  1333.   MESSAGE BASE PACKING
  1334.   ────────────────────
  1335.  
  1336.   If you have more than 1 group setup, you'll need to pack the
  1337.   message conferences in each group. To do this, you'll need to make a
  1338.   SFNODE.DAT file for each group with the correct message directory.
  1339.   You should make a SFNODE.1 for group 1, SFNODE.2 for group 2, etc. for
  1340.   all groups. The SFNODE.1 will have the message directory for group 1,
  1341.   SFNODE.2 will have the message directory for group 2, etc. Below is
  1342.   an example of how to use SFPCKMSG to pack all your message groups.
  1343.  
  1344.   Example:
  1345.      CD C:\SF
  1346.      REM Save original SFMCONF.DAT
  1347.      COPY SFMCONF.DAT SFMCONF.BAK
  1348.  
  1349.      REM Save original SFNODE.DAT
  1350.      COPY SFNODE.DAT SFNODE.BAK
  1351.  
  1352.      REM Copy group #1's conference data file to C:\SF\SFMCONF.DAT
  1353.      COPY C:\SF\SFAME\SFMCONF.1 SFMCONF.DAT
  1354.  
  1355.      REM Copy group #1's SFNODE file to SFNODE.DAT
  1356.      COPY SFNODE.1 SFNODE.DAT
  1357.      SFPCKMSG /OLD=15 /POT /POU /PRM /ALL /SIZE=300
  1358.  
  1359.      REM Copy group #2's conference data file to C:\SF\SFMCONF.DAT
  1360.      COPY C:\SF\SFAME\SFMCONF.2 SFMCONF.DAT
  1361.  
  1362.      REM Copy group #2's SFNODE file to SFNODE.DAT
  1363.      COPY SFNODE.2 SFNODE.DAT
  1364.      SFPCKMSG /OLD=15 /POT /POU /PRM /ALL /SIZE=300
  1365.  
  1366.      REM Copy group #3's conference data file to C:\SF\SFMCONF.DAT
  1367.      COPY C:\SF\SFAME\SFMCONF.3 SFMCONF.DAT
  1368.  
  1369.      REM Copy group #3's SFNODE file to SFNODE.DAT
  1370.      COPY SFNODE.3 SFNODE.DAT
  1371.      SFPCKMSG /OLD=15 /POT /POU /PRM /ALL /SIZE=300
  1372.  
  1373.      REM Restore original SFMCONF.DAT
  1374.      COPY SFMCONF.BAK SFMCONF.DAT
  1375.  
  1376.      REM Restore original SFNODE.DAT
  1377.      COPY SFNODE.BAK SFNODE.DAT
  1378.  
  1379.   The above example will copy the SFMCONF.DAT and SFNODE.DAT file
  1380.   for each group and then pack the message base for that group.
  1381.  
  1382.   UTILITIES
  1383.   ─────────
  1384.  
  1385.   There are 3 other programs included with SFAME. The CONFIG program
  1386.   is described above. The TESTSCR program will test your script files
  1387.   and display a message if a problem is found in a script. To use TESTSCR,
  1388.   type TESTSCR <script name>. First, TESTSCR will read each line to make
  1389.   sure all commands are valid. It will then run the script so you can test
  1390.   the script before putting it on-line. The other program is called
  1391.   SFAMEUQ.EXE. This program will read the NEWQUEUE.DAT file and will update
  1392.   the users queue in the SFUSERS.DAT file. It should be run from your
  1393.   SFINIT.BAT file after every caller. This program is needed because when
  1394.   a caller returns from SFAME, any changes made to their conference queue
  1395.   are lost. You don't need to use SFAMEUQ if you run SFAME from the DOORS
  1396.   menu. You do need to use it if SFAME is run from a menu extension.
  1397.  
  1398.  
  1399.   FEATURES
  1400.   ────────
  1401.  
  1402.   Multi-node support
  1403.   ──────────────────
  1404.      SFAME has full file sharing and locking built in using Mike Woltz's
  1405.      BCShare. You can use the same SFAME directory and files on as many nodes
  1406.      as you like. You only need one copy of the SFAME files to handle any
  1407.      number of nodes. If you use the same copy of SFAME for all nodes, you
  1408.      must mark the files read-only or you will get DOS share errors. Go to
  1409.      the SFAME home directory and type these 2 lines:
  1410.  
  1411.        ATTRIB +R *.EXE
  1412.        ATTRIB +R *.OVR
  1413.  
  1414.  
  1415.   Multi-Tasking
  1416.   ─────────────
  1417.      SFAME supports the following multi-taskers and will release
  1418.      its time slices while idle.
  1419.  
  1420.      Windows 3.x & NT
  1421.      DESQview 2.xx
  1422.      DoubleDOS
  1423.      VMiX 2.xx
  1424.      MultiDos Plus 4.xx
  1425.      OS/2 2.0+
  1426.      DOS 5.0 Task Switcher and Compatibles
  1427.      TaskView, TopView, OmniView, & Compatibles
  1428.  
  1429.   Com Ports
  1430.   ─────────
  1431.      Can use ports 1 - 8 with support for non-standard IRQs. SFAME
  1432.      uses the IRQ and com port base address information in the
  1433.      SFNODE.DAT file.
  1434.  
  1435.   Note: SFAME uses High Ascii characters for quote box types 2,3, and 4.
  1436.         Fidonet does not allow high ascii in messages so you should set
  1437.         your mail scanner to strip or convert any high ascii characters.
  1438.  
  1439.   Disclaimer
  1440.   ──────────
  1441.      Use this program at your own risk. There are no guarantees
  1442.      that SFAME will run on your system. Richard Lemaster shall
  1443.      not be held responsible for any damages incurred while running
  1444.      SFAME, CONFIG, SFAMEUQ, or TESTSCR. The user accepts all
  1445.      responsibility when using these programs.
  1446.  
  1447.  
  1448.   HELP
  1449.   ────
  1450.      If you have any questions, suggestions or problems with SFAME, you
  1451.      can leave me, Richard Lemaster, a message on my BBS or in the SFNET
  1452.      3rd Party Conference.
  1453.  
  1454.  
  1455.   REGISTRATION
  1456.   ────────────
  1457.  
  1458.      Registration for SFAME is only $15. You can pay by check or money
  1459.      order. Any checks from outside the US must be for $20 because the banks
  1460.      won't cash a foreign check under $20. So if your outside the US, its
  1461.      better to send a $15 money order.
  1462.  
  1463.      Unregistered versions of SFAME are limited to 2 groups and 1 script.
  1464.      All features work in both reg. and unregistered versions.
  1465.  
  1466.      Once registered, all future upgrades are free. You will only need the
  1467.      latest version. Your SFAME.KEY file will work with all future versions.
  1468.  
  1469.      You can either call my BBS to pick up your key or I can send it to
  1470.      you netmail if you have a Fidonet address. I can also send it
  1471.      uu-encoded by Internet E-Mail.
  1472.  
  1473.  Information needed for registration
  1474.  ----------------------------------------------------------------------
  1475.    SFAME Registration Form
  1476.  
  1477.    BBS Name (up to 50 chars):________________________________________
  1478.  
  1479.    Sysop Name (up to 30 chars):______________________________
  1480.  
  1481.  
  1482.             * If you want your key sent to you by netmail *
  1483.  
  1484.    What is your Fidonet node number:
  1485.  
  1486.        * If you want it sent to you uu-encoded by Internet E-Mail *
  1487.  
  1488.    What is your Internet E-Mail address:
  1489.  
  1490.  ----------------------------------------------------------------------
  1491.  To register, simply fill out the questions above and mail it and a
  1492.  check, or money order for $15 ($20 outside US) to:
  1493.  
  1494.   Richard Lemaster
  1495.   7332 So. 74 E Ave.
  1496.   Tulsa, Ok
  1497.   74133
  1498.  
  1499.  If you have any suggestions, comments, or problems with SFAME or the
  1500.  included utilities, you can leave me a message in the SFNET 3rd Party
  1501.  conference or the Fidonet Spitfire conference. The best way to contact
  1502.  me would be to call my BBS listed below.
  1503.  
  1504.   Over The Line BBS
  1505.   Richard Lemaster - Sysop
  1506.   Fidonet  - 1:170/260
  1507.   Internet - sysop@otlbbs.com
  1508.   Line 1:(918)250-0542 28.8
  1509.   Line 2:(918)250-2462 14.4
  1510.  
  1511.  The latest version can always be FREQ'ed with the magic name "SFAME"
  1512.  from me at 1:170/260.
  1513.  
  1514.  You can also send Internet E-Mail to sfame@otlbbs.com for a uuencoded
  1515.  copy of the latest version.
  1516.  
  1517.  Thanks to Jacque Shipley for helping develop and test SFAME.
  1518.  
  1519.  File sharing and locking are from BCShare by Mike Woltz.
  1520.  
  1521.   "SPITFIRE" is Copyright (C) 1987-1996 by Mike Woltz.
  1522.   "SPITFIRE" is a registered trademark of Buffalo Creek Software.
  1523.   "BCSHARE"  is Copyright (C) 1990 by Mike Woltz.
  1524.